home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_cups.idb / usr / freeware / etc / cups / cupsd.conf.z / cupsd.conf
Text File  |  2002-04-08  |  19KB  |  721 lines
  1. #
  2. # "$Id: cupsd.conf.in,v 1.3 2002/02/12 18:47:11 mike Exp $"
  3. #
  4. #   Sample configuration file for the Common UNIX Printing System (CUPS)
  5. #   scheduler.
  6. #
  7. #   Copyright 1997-2002 by Easy Software Products, all rights reserved.
  8. #
  9. #   These coded instructions, statements, and computer programs are the
  10. #   property of Easy Software Products and are protected by Federal
  11. #   copyright law.  Distribution and use rights are outlined in the file
  12. #   "LICENSE.txt" which should have been included with this file.  If this
  13. #   file is missing or damaged please contact Easy Software Products
  14. #   at:
  15. #
  16. #       Attn: CUPS Licensing Information
  17. #       Easy Software Products
  18. #       44141 Airport View Drive, Suite 204
  19. #       Hollywood, Maryland 20636-3111 USA
  20. #
  21. #       Voice: (301) 373-9603
  22. #       EMail: cups-info@cups.org
  23. #         WWW: http://www.cups.org
  24. #
  25.  
  26. ########################################################################
  27. #                                                                      #
  28. # This is the CUPS configuration file.  If you are familiar with       #
  29. # Apache or any of the other popular web servers, we've followed the   #
  30. # same format.  Any configuration variable used here has the same      #
  31. # semantics as the corresponding variable in Apache.  If we need       #
  32. # different functionality then a different name is used to avoid       #
  33. # confusion...                                                         #
  34. #                                                                      #
  35. ########################################################################
  36.  
  37.  
  38. ########
  39. ######## Server Identity
  40. ########
  41.  
  42. #
  43. # ServerName: the hostname of your server, as advertised to the world.
  44. # By default CUPS will use the hostname of the system.
  45. #
  46. # To set the default server used by clients, see the client.conf file.
  47. #
  48.  
  49. #ServerName myhost.domain.com
  50.  
  51. #
  52. # ServerAdmin: the email address to send all complaints/problems to.
  53. # By default CUPS will use "root@hostname".
  54. #
  55.  
  56. #ServerAdmin root@your.domain.com
  57.  
  58.  
  59. ########
  60. ######## Server Options
  61. ########
  62.  
  63. #
  64. # AccessLog: the access log file; if this does not start with a leading /
  65. # then it is assumed to be relative to ServerRoot.  By default set to
  66. # "/var/cups/access_log"
  67. #
  68. # You can also use the special name "syslog" to send the output to the
  69. # syslog file or daemon.
  70. #
  71.  
  72. #AccessLog /var/cups/access_log
  73.  
  74. #
  75. # Classification: the classification level of the server.  If set, this
  76. # classification is displayed on all pages, and raw printing is disabled.
  77. # The default is the empty string.
  78. #
  79.  
  80. #Classification classified
  81. #Classification confidential
  82. #Classification secret
  83. #Classification topsecret
  84. #Classification unclassified
  85.  
  86. #
  87. # ClassifyOverride: whether to allow users to override the classification
  88. # on printouts. If enabled, users can limit banner pages to before or
  89. # after the job, and can change the classification of a job, but cannot
  90. # completely eliminate the classification or banners.
  91. #
  92. # The default is off.
  93. #
  94.  
  95. #ClassifyOverride off
  96.  
  97. #
  98. # DataDir: the root directory for the CUPS data files.
  99. # By default "/usr/freeware/share/cups".
  100. #
  101.  
  102. #DataDir /usr/freeware/share/cups
  103.  
  104. #
  105. # DefaultCharset: the default character set to use. If not specified,
  106. # defaults to "utf-8".  Note that this can also be overridden in
  107. # HTML documents...
  108. #
  109.  
  110. #DefaultCharset utf-8
  111.  
  112. #
  113. # DefaultLanguage: the default language if not specified by the browser.
  114. # If not specified, the current locale is used.
  115. #
  116.  
  117. #DefaultLanguage en
  118.  
  119. #
  120. # DocumentRoot: the root directory for HTTP documents that are served.
  121. # By default "/usr/freeware/share/doc/cups".
  122. #
  123.  
  124. #DocumentRoot /usr/freeware/share/doc/cups
  125.  
  126. #
  127. # ErrorLog: the error log file; if this does not start with a leading /
  128. # then it is assumed to be relative to ServerRoot.  By default set to
  129. # "/var/cups/error_log"
  130. #
  131. # You can also use the special name "syslog" to send the output to the
  132. # syslog file or daemon.
  133. #
  134.  
  135. #ErrorLog /var/cups/error_log
  136.  
  137. #
  138. # FontPath: the path to locate all font files (currently only for pstoraster)
  139. # By default "/usr/freeware/share/cups/fonts".
  140. #
  141.  
  142. #FontPath /usr/freeware/share/cups/fonts
  143.  
  144. #
  145. # LogLevel: controls the number of messages logged to the ErrorLog
  146. # file and can be one of the following:
  147. #
  148. #     debug2    Log everything.
  149. #     debug    Log almost everything.
  150. #     info      Log all requests and state changes.
  151. #     warn      Log errors and warnings.
  152. #     error     Log only errors.
  153. #     none      Log nothing.
  154. #
  155.  
  156. LogLevel info
  157.  
  158. #
  159. # MaxLogSize: controls the maximum size of each log file before they are
  160. # rotated.  Defaults to 1048576 (1MB).  Set to 0 to disable log rotating.
  161. #
  162.  
  163. #MaxLogSize 0
  164.  
  165. #
  166. # PageLog: the page log file; if this does not start with a leading /
  167. # then it is assumed to be relative to ServerRoot.  By default set to
  168. # "/var/cups/page_log"
  169. #
  170. # You can also use the special name "syslog" to send the output to the
  171. # syslog file or daemon.
  172. #
  173.  
  174. #PageLog /var/cups/page_log
  175.  
  176. #
  177. # PreserveJobHistory: whether or not to preserve the job history after a
  178. # job is completed, cancelled, or stopped.  Default is Yes.
  179. #
  180.  
  181. #PreserveJobHistory Yes
  182.  
  183. #
  184. # PreserveJobFiles: whether or not to preserve the job files after a
  185. # job is completed, cancelled, or stopped.  Default is No.
  186. #
  187.  
  188. #PreserveJobFiles No
  189.  
  190. #
  191. # AutoPurgeJobs: automatically purge jobs when not needed for quotas.
  192. # Default is No.
  193. #
  194.  
  195. #AutoPurgeJobs No
  196.  
  197. #
  198. # MaxJobs: maximum number of jobs to keep in memory (active and completed.)
  199. # Default is 500; the value 0 is used for no limit.
  200. #
  201.  
  202. #MaxJobs 500
  203.  
  204. #
  205. # Printcap: the name of the printcap file.  Default is /etc/printcap.
  206. # Leave blank to disable printcap file generation.
  207. #
  208.  
  209. #Printcap /etc/printcap
  210.  
  211. #
  212. # PrintcapFormat: the format of the printcap file, currently either
  213. # BSD or Solaris.  The default is "BSD".
  214. #
  215.  
  216. #PrintcapFormat BSD
  217. #PrintcapFormat Solaris
  218.  
  219. #
  220. # PrintcapGUI: the name of the GUI options panel program to associate
  221. # with print queues under IRIX.  The default is "/usr/bin/glpoptions"
  222. # from ESP Print Pro.
  223. #
  224. # This option is only used under IRIX; the options panel program
  225. # must accept the "-d printer" and "-o options" options and write
  226. # the selected printer options back to stdout on completion.
  227. #
  228.  
  229. #PrintcapGUI /usr/bin/glpoptions
  230.  
  231. #
  232. # RequestRoot: the directory where request files are stored.
  233. # By default "/var/spool/cups".
  234. #
  235.  
  236. #RequestRoot /var/spool/cups
  237.  
  238. #
  239. # RemoteRoot: the name of the user assigned to unauthenticated accesses
  240. # from remote systems.  By default "remroot".
  241. #
  242.  
  243. #RemoteRoot remroot
  244.  
  245. #
  246. # ServerBin: the root directory for the scheduler executables.
  247. # By default "/usr/freeware/lib/cups".
  248. #
  249.  
  250. #ServerBin /usr/freeware/lib/cups
  251.  
  252. #
  253. # ServerRoot: the root directory for the scheduler.
  254. # By default "/usr/freeware/etc/cups".
  255. #
  256.  
  257. #ServerRoot /usr/freeware/etc/cups
  258.  
  259.  
  260. ########
  261. ######## Encryption Support
  262. ########
  263.  
  264. #
  265. # ServerCertificate: the file to read containing the server's certificate.
  266. # Defaults to "/usr/freeware/etc/cups/ssl/server.crt".
  267. #
  268.  
  269. #ServerCertificate /usr/freeware/etc/cups/ssl/server.crt
  270.  
  271. #
  272. # ServerKey: the file to read containing the server's key.
  273. # Defaults to "/usr/freeware/etc/cups/ssl/server.key".
  274. #
  275.  
  276. #ServerKey /usr/freeware/etc/cups/ssl/server.key
  277.  
  278.  
  279. ########
  280. ######## Filter Options
  281. ########
  282.  
  283. #
  284. # User/Group: the user and group the server runs under.  Normally this
  285. # must be lp and sys, however you can configure things for another
  286. # user or group as needed.
  287. #
  288. # Note: the server must be run initially as root to support the
  289. # default IPP port of 631.  It changes users whenever an external
  290. # program is run, or if the RunAsUser directive is specified...
  291. #
  292.  
  293. #User lp
  294. #Group sys
  295.  
  296. #
  297. # RIPCache: the amount of memory that each RIP should use to cache
  298. # bitmaps.  The value can be any real number followed by "k" for
  299. # kilobytes, "m" for megabytes, "g" for gigabytes, or "t" for tiles
  300. # (1 tile = 256x256 pixels.)  Defaults to "8m" (8 megabytes).
  301. #
  302.  
  303. #RIPCache 8m
  304.  
  305. #
  306. # TempDir: the directory to put temporary files in.  This directory must be
  307. # writable by the user defined above!  Defaults to "/var/spool/cups/tmp" or
  308. # the value of the TMPDIR environment variable.
  309. #
  310.  
  311. #TempDir /var/spool/cups/tmp
  312.  
  313. #
  314. # FilterLimit: sets the maximum cost of all job filters that can be run
  315. # at the same time.  A limit of 0 means no limit.  A typical job may need
  316. # a filter limit of at least 200; limits less than the minimum required
  317. # by a job force a single job to be printed at any time.
  318. #
  319. # The default limit is 0 (unlimited).
  320. #
  321.  
  322. #FilterLimit 0
  323.  
  324. ########
  325. ######## Network Options
  326. ########
  327.  
  328. #
  329. # Ports/addresses that we listen to.  The default port 631 is reserved
  330. # for the Internet Printing Protocol (IPP) and is what we use here.
  331. #
  332. # You can have multiple Port/Listen lines to listen to more than one
  333. # port or address, or to restrict access:
  334. #
  335. #    Port 80
  336. #    Port 631
  337. #    Listen hostname
  338. #    Listen hostname:80
  339. #    Listen hostname:631
  340. #    Listen 1.2.3.4
  341. #    Listen 1.2.3.4:631
  342. # 
  343. # NOTE: Unfortunately, most web browsers don't support TLS or HTTP Upgrades
  344. # for encryption.  If you want to support web-based encryption you'll
  345. # probably need to listen on port 443 (the "https" port...)
  346. #
  347.  
  348. #Port 80
  349. #Port 443
  350. Port 631
  351.  
  352. #
  353. # HostNameLookups: whether or not to do lookups on IP addresses to get a
  354. # fully-qualified hostname.  This defaults to Off for performance reasons...
  355. #
  356.  
  357. #HostNameLookups On
  358.  
  359. #
  360. # KeepAlive: whether or not to support the Keep-Alive connection
  361. # option.  Default is on.
  362. #
  363.  
  364. #KeepAlive On
  365.  
  366. #
  367. # KeepAliveTimeout: the timeout before Keep-Alive connections are
  368. # automatically closed.  Default is 60 seconds.
  369. #
  370.  
  371. #KeepAliveTimeout 60
  372.  
  373. #
  374. # MaxClients: controls the maximum number of simultaneous clients that
  375. # will be handled.  Defaults to 100.
  376. #
  377.  
  378. #MaxClients 100
  379.  
  380. #
  381. # MaxRequestSize: controls the maximum size of HTTP requests and print files.
  382. # Set to 0 to disable this feature (defaults to 0.)
  383. #
  384.  
  385. #MaxRequestSize 0
  386.  
  387. #
  388. # Timeout: the timeout before requests time out.  Default is 300 seconds.
  389. #
  390.  
  391. #Timeout 300
  392.  
  393.  
  394. ########
  395. ######## Browsing Options
  396. ########
  397.  
  398. #
  399. # Browsing: whether or not to broadcast and/or listen for CUPS printer
  400. # information on the network.  Enabled by default.
  401. #
  402.  
  403. #Browsing On
  404.  
  405. #
  406. # BrowseProtocols: which protocols to use for browsing.  Can be
  407. # any of the following separated by whitespace and/or commas:
  408. #
  409. #     all  - Use all supported protocols.
  410. #     cups - Use the CUPS browse protocol.
  411. #     slp  - Use the SLPv2 protocol.
  412. #
  413. # The default is "cups".
  414. #
  415. # NOTE: If you choose to use SLPv2, it is *strongly* recommended that
  416. #       you have at least one SLP Directory Agent (DA) on your
  417. #       network.  Otherwise, browse updates can take several seconds,
  418. #       during which the scheduler will not response to client
  419. #       requests.
  420. #
  421.  
  422. #BrowseProtocols cups
  423.  
  424. #
  425. # BrowseAddress: specifies a broadcast address to be used.  By
  426. # default browsing information is not sent!
  427. #
  428. # Note: HP-UX does not properly handle broadcast unless you have a
  429. # Class A, B, C, or D netmask (i.e. no CIDR support).
  430. #
  431. # Note: Using the "global" broadcast address (255.255.255.255) will
  432. # activate a Linux demand-dial link with the default configuration.
  433. # If you have a LAN as well as the dial-up link, use the LAN's
  434. # broadcast address.
  435. #
  436.  
  437. #BrowseAddress x.y.z.255
  438. #BrowseAddress x.y.255.255
  439. #BrowseAddress x.255.255.255
  440. #BrowseAddress 255.255.255.255
  441.  
  442. #
  443. # BrowseShortNames: whether or not to use "short" names for remote printers
  444. # when possible (e.g. "printer" instead of "printer@host".)  Enabled by
  445. # default.
  446. #
  447.  
  448. #BrowseShortNames Yes
  449.  
  450. #
  451. # BrowseAllow: specifies an address mask to allow for incoming browser
  452. # packets. The default is to allow packets from all addresses.
  453. #
  454. # BrowseDeny: specifies an address mask to deny for incoming browser
  455. # packets. The default is to deny packets from no addresses.
  456. #
  457. # Both "BrowseAllow" and "BrowseDeny" accept the following notations for
  458. # addresses:
  459. #
  460. #     All
  461. #     None
  462. #     *.domain.com
  463. #     .domain.com
  464. #     host.domain.com
  465. #     nnn.*
  466. #     nnn.nnn.*
  467. #     nnn.nnn.nnn.*
  468. #     nnn.nnn.nnn.nnn
  469. #     nnn.nnn.nnn.nnn/mm
  470. #     nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
  471. #
  472. # The hostname/domainname restrictions only work if you have turned hostname
  473. # lookups on!
  474. #
  475.  
  476. #BrowseAllow address
  477. #BrowseDeny address
  478.  
  479. #
  480. # BrowseInterval: the time between browsing updates in seconds.  Default
  481. # is 30 seconds.
  482. #
  483. # Note that browsing information is sent whenever a printer's state changes
  484. # as well, so this represents the maximum time between updates.
  485. #
  486. # Set this to 0 to disable outgoing broadcasts so your local printers are
  487. # not advertised but you can still see printers on other hosts.
  488. #
  489.  
  490. #BrowseInterval 30
  491.  
  492. #
  493. # BrowseOrder: specifies the order of BrowseAllow/BrowseDeny comparisons.
  494. #
  495.  
  496. #BrowseOrder allow,deny
  497. #BrowseOrder deny,allow
  498.  
  499. #
  500. # BrowsePoll: poll the named server(s) for printers
  501. #
  502.  
  503. #BrowsePoll address:port
  504.  
  505. #
  506. # BrowsePort: the port used for UDP broadcasts.  By default this is
  507. # the IPP port; if you change this you need to do it on all servers.
  508. # Only one BrowsePort is recognized.
  509. #
  510.  
  511. #BrowsePort 631
  512.  
  513. #
  514. # BrowseRelay: relay browser packets from one address/network to another.
  515. #
  516.  
  517. #BrowseRelay source-address destination-address
  518.  
  519. #
  520. # BrowseTimeout: the timeout for network printers - if we don't
  521. # get an update within this time the printer will be removed
  522. # from the printer list.  This number definitely should not be
  523. # less the BrowseInterval value for obvious reasons.  Defaults
  524. # to 300 seconds.
  525. #
  526.  
  527. #BrowseTimeout 300
  528.  
  529. #
  530. # ImplicitClasses: whether or not to use implicit classes.
  531. #
  532. # Printer classes can be specified explicitly in the classes.conf
  533. # file, implicitly based upon the printers available on the LAN, or
  534. # both.
  535. #
  536. # When ImplicitClasses is On, printers on the LAN with the same name
  537. # (e.g. Acme-LaserPrint-1000) will be put into a class with the same
  538. # name. This allows you to setup multiple redundant queues on a LAN
  539. # without a lot of administrative difficulties.  If a user sends a
  540. # job to Acme-LaserPrint-1000, the job will go to the first available
  541. # queue.
  542. #
  543. # Enabled by default.
  544. #
  545.  
  546. #ImplicitClasses On
  547.  
  548. #
  549. # ImplicitAnyClasses: whether or not to create "AnyPrinter" implicit
  550. # classes.
  551. #
  552. # When ImplicitAnyClasses is On and a local queue of the same name
  553. # exists, e.g. "printer", "printer@server1", "printer@server1", then
  554. # an implicit class called "Anyprinter" is created instead.
  555. #
  556. # When ImplicitAnyClasses is Off, implicit classes are not created
  557. # when there is a local queue of the same name.
  558. #
  559. # Disabled by default.
  560. #
  561.  
  562. #ImplicitAnyCLasses Off
  563.  
  564. #
  565. # HideImplicitMembers: whether or not to show the members of an
  566. # implicit class.
  567. #
  568. # When HideImplicitMembers is On, any remote printers that are
  569. # part of an implicit class are hidden from the user, who will
  570. # then only see a single queue even though many queues will be
  571. # supporting the implicit class.
  572. #
  573. # Enabled by default.
  574. #
  575.  
  576. #HideImplicitMembers On
  577.  
  578.  
  579. ########
  580. ######## Security Options
  581. ########
  582.  
  583. #
  584. # SystemGroup: the group name for "System" (printer administration)
  585. # access.  The default varies depending on the operating system, but
  586. # will be "sys", "system", or "root" (checked for in that order.)
  587. #
  588.  
  589. #SystemGroup sys
  590.  
  591. #
  592. # Access permissions for each directory served by the scheduler.
  593. # Locations are relative to DocumentRoot...
  594. #
  595. # AuthType: the authorization to use:
  596. #
  597. #    None   - Perform no authentication
  598. #    Basic  - Perform authentication using the HTTP Basic method.
  599. #    Digest - Perform authentication using the HTTP Digest method.
  600. #
  601. #    (Note: local certificate authentication can be substituted by
  602. #           the client for Basic or Digest when connecting to the
  603. #           localhost interface)
  604. #
  605. # AuthClass: the authorization class; currently only "Anonymous", "User",
  606. # "System" (valid user belonging to group SystemGroup), and "Group"
  607. # (valid user belonging to the specified group) are supported.
  608. #
  609. # AuthGroupName: the group name for "Group" authorization.
  610. #
  611. # Order: the order of Allow/Deny processing.
  612. #
  613. # Allow: allows access from the specified hostname, domain, IP address, or
  614. # network.
  615. #
  616. # Deny: denies access from the specified hostname, domain, IP address, or
  617. # network.
  618. #
  619. # Both "Allow" and "Deny" accept the following notations for addresses:
  620. #
  621. #     All
  622. #     None
  623. #     *.domain.com
  624. #     .domain.com
  625. #     host.domain.com
  626. #     nnn.*
  627. #     nnn.nnn.*
  628. #     nnn.nnn.nnn.*
  629. #     nnn.nnn.nnn.nnn
  630. #     nnn.nnn.nnn.nnn/mm
  631. #     nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
  632. #
  633. # The host and domain address require that you enable hostname lookups
  634. # with "HostNameLookups On" above.
  635. #
  636. # Encryption: whether or not to use encryption; this depends on having
  637. # the OpenSSL library linked into the CUPS library and scheduler.
  638. #
  639. # Possible values:
  640. #
  641. #     Always       - Always use encryption (SSL)
  642. #     Never        - Never use encryption
  643. #     Required     - Use TLS encryption upgrade
  644. #     IfRequested  - Use encryption if the server requests it
  645. #
  646. # The default value is "IfRequested".
  647. #
  648.  
  649. <Location />
  650. Order Deny,Allow
  651. Deny From All
  652. Allow From 127.0.0.1
  653. </Location>
  654.  
  655. #<Location /classes>
  656. #
  657. # You may wish to limit access to printers and classes, either with Allow
  658. # and Deny lines, or by requiring a username and password.
  659. #
  660. #</Location>
  661.  
  662. #<Location /classes/name>
  663. #
  664. # You may wish to limit access to printers and classes, either with Allow
  665. # and Deny lines, or by requiring a username and password.
  666. #
  667. #</Location>
  668.  
  669. #<Location /printers>
  670. #
  671. # You may wish to limit access to printers and classes, either with Allow
  672. # and Deny lines, or by requiring a username and password.
  673. #
  674. #</Location>
  675.  
  676. #<Location /printers/name>
  677. #
  678. # You may wish to limit access to printers and classes, either with Allow
  679. # and Deny lines, or by requiring a username and password.
  680. #
  681.  
  682. ## Anonymous access (default)
  683. #AuthType None
  684.  
  685. ## Require a username and password (Basic authentication)
  686. #AuthType Basic
  687. #AuthClass User
  688.  
  689. ## Require a username and password (Digest/MD5 authentication)
  690. #AuthType Digest
  691. #AuthClass User
  692.  
  693. ## Restrict access to local domain
  694. #Order Deny,Allow
  695. #Deny From All
  696. #Allow From .mydomain.com
  697. #</Location>
  698.  
  699. <Location /admin>
  700. #
  701. # You definitely will want to limit access to the administration functions.
  702. # The default configuration requires a local connection from a user who
  703. # is a member of the system group to do any admin tasks.  You can change
  704. # the group name using the SystemGroup directive.
  705. #
  706.  
  707. AuthType Basic
  708. AuthClass System
  709.  
  710. ## Restrict access to local domain
  711. Order Deny,Allow
  712. Deny From All
  713. Allow From 127.0.0.1
  714.  
  715. #Encryption Required
  716. </Location>
  717.  
  718. #
  719. # End of "$Id: cupsd.conf.in,v 1.3 2002/02/12 18:47:11 mike Exp $".
  720. #
  721.